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NOTES 


The Axel-VNCviewer is the AX3000 TCP/IP Platine Terminal model 65 or 65E 
equipped with VNC firmware. In this document we assume that the AX3000 has 
been fitted with this firmware. 

This documentation deals only with features specific to the Axel-VNCviewer. We 
assume that the reader is already familiar with the AX3000 set up procedures. 
For more information, please read the AX3000 TCP/IP - User's Manual. 
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The VNC protocol enables a remote graphical display on the Axel-VNCviewer. 
The image is constructed, maintained and updated within the Unix server’s 
frame buffer, and transmitted across the TCP/IP network. 


Note: this protocol is public and the associated software is free. For more 
information please see http://www.uk.research.att.com/vnc . 

VNC protocol information: 

- Server side: the VNC server daemon (Xvnc) is required. This software is 
an X server with embedded VNC. 

- Client side (called VNC viewer): the AX3000 must support VNC. 

-VNC protocol key points: display update requests are sent by the 
viewer. An update request can be incremental (the part of the display that 
changed is transmitted) or total (the complete display is updated). 
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2.1 - SETTING UP A VNC SESSION 

This chapter deals only with the VNC session set-up. We assume that the other 
set-up parameters (such as AX3000 IP address, hosts, routers, etc.) have been 
already set. For more information please read AX3000 TCP/IP - User's Manual. 

To set-up a VNC session, enter the AX3000 Set-Up (<Ctrl><AltxEsc>) select 
[Configuration]-»[Terminal]-»[Session X] (where X is the session number). 
The following dialog box is displayed: 



Set the following parameters: 

- Protocol: vnc 

- Host: the hostname on which the Xvnc daemon is run 

-TCP Port: numeric value associated with the DISPLAY environment (see 
Chapter 3): 

5901 : DISPLAY =1 

5902 : DISPLAY = 2 

-Auto Connection: yes or no, to automatically connect this session on 
power up. 
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-Auto Reconnection: yes or no, to automatically connect this session on 
re-connection. 

- General Parameters: press <Space> to display the following box: 


■l].ILi«ilU.IU4CTEH 


Resolut ion 


00x600 


Shared Session 

Keyboard and no use ignored 

Local nouse cursor 
Enulate a 3-button nouse 
Mouse accelerator 


flTPFTi] 


ANCEL 


These parameters are: 

-Resolution: the default resolution of a VNC session is 800x600. 
Press <Space> to change to 1024x768. 

Note: to check if the 1024x768 resolution is available refer to 
Chapter 6.4. 

-Shared Session and Keyboard and Mouse Ignored: these 
parameters allow several VNC terminals to share the same 
graphical display. For more information, refer to Chapter 6.2. 

- Local Mouse Cursor: if 'yes', the local mouse cursor location is 
indicated by a little square pointer (2x2 pixels). This could be useful 
when the local mouse cursor location is different from the VNC 
cursor location (for example when the Unix/Linux box or the 
network are overloaded). 

- Emulate a 3-button Mouse: if 'yes', the mouse middle button is 
emulated by clicking both left and right buttons. 

- Mouse Accelerator: if 'yes', the AX3000 speeds up the mouse 
cursor. 

Note: after exiting set-up, we advise a power-cycle of the AX3000. 
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2.2 - SETTING UP THE MOUSE 

The VNC Platine Terminal controls either PS/2 mouse or a serial 2-button 
mouse. 

2.2.1 - PS/2 Mouse 


The PS/2 mouse is automatically enabled when a VNC session is set. 

In event of problem, enter the AX3000 Set-Up (<CtrlxAltxEsc>) and select 
the [Configuration]-»[Terminal]-»[General] menu. Within the displayed dialog 
box, set the "Mouse" parameter to "PS2". 

2.2.2 - Serial 2-button Mouse 


Attach this mouse to the AUX2 port (if needed, use RJ45-9pts adaptor 
supplied). 

Note: for electrical reasons, only a native serial mouse or a combo-mouse 
(supporting both serial and PS/2 protocol) can be connected. For example, a 
exclusive PS/2 mouse (equipped with a "9pts-PS/2" adaptor) won’t work. 

To set-up the serial mouse, perform the following: 

- enter the AX3000 Set-Up (<CtrlxAltxEsc>), 

- select [Configuration]-»[Terminal]->[ General], 

- within this dialog box, set "Mouse" to "AUX2", 

- select [Configuration]-»[Aux. Ports]-»[AUX2 (RJ45)], 

- within this dialog box, set "Operating Mode" to "Mouse", 

- exit the set-up, 

- power-cycle the AX3000. 
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3.1 - PREREQUISITS 


Warning: it is assumed that the XII environment is already installed (utilities, 
directories and files) on the Unix/Linux server. 


Mount the Axel CD-ROM and copy the following files onto the hard disk: 

-Xvnc (VNC server, on CD supplied, under /bin). Copy and rename as 
‘Xvnc’ the appropriate binary (Xvnc. SCO, Xvnc. LINUX, Xvnc.UW7, 
Xvnc.AlX) to a local directory (ie /usr/local/bin). Set execute permission by 
invoking chmod +x Xvnc. 

-vncpasswd (VNC authentication, on CD supplied, under /bin). Copy and 
rename as 'vncpasswd' the appropriate binary (vncpasswd. SCO, 
vncpasswd. LINUX, vncpasswd. UW7, vncpasswd.AlX) to a local directory 
(i.e. /usr/local/bin). Set execute permission by invoking chmod +x 
vncpasswd. 

-axvnc (VNC configuration utility, on CD supplied, under /bin). Copy axvnc 
to /etc. Set execute permission by invoking chmod +x axvnc. 

- other files: copy files located in /misc to /tmp: 

- xservers.SCO (for SCO OpenServer 5.0.5), 

- govnc.SCO (for previous SCO versions), 

- govnc. LINUX (for Linux with gdm), 

- govnc. KDE22 (for Linux with KDE 2.2), 

- xservers. LINUX (for Linux), 

- xservers. UW7 (for UnixWare 7), 

- xservers. OU8 (for Open Unix 8), 

- xservers. AIX (for AIX), 

- xservers. SUN (for SUN), 

- xservers. HPUX (for HP-UX), 

- runNS (autorun script for Netscape), 

- runRDP (autorun script for rdesktop). 


3.2 - THE CONFIGURATION UTILITY: AXVNC 

The axvnc configuration utility can be used to easily set up the Unix/Linux 
server. This script has been certified for Linux, SCO OpenServer and 
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UnixWare 7, Sun OS and HP-UX environments. For other environments manual 
configuration is required. 

The axvnc utility must be run from the graphical Unix/Linux console by invoking 

/etc/axvnc. 

The first operation performed by axvnc is to check the system has the 
necessary components for correct VNC operation: 

AXEL VNC UTILITY (VI. 2-0) 


Checking system configuration: 

- Operating System: 

— > Linux (runlevel 5) 

- VNC server (Xvnc) : 

— > OK 

- Misc Utilities: 

— > OK 

- Xll font: 

— > unix/ : -1 

Press <CR> 


Note: if the default font paths given by the O.S are not needed, use the '-nofp' 
option when axvnc is run. 

The second screen gives two choices: 

-The user being presented with a standard Unix/Linux desktop following a 
graphical login. 

-The ability to run a program or script without running the X display 
manager. (For example ‘rdesktop’ or ‘netscape’ can be run without an 
underlying display manager reducing memory and CPU requirements). 

AXEL VNC UTILITY (VI. 2-0) 


This utility allows you to set-up Unix/Linux to run automatically at boot time 
Xvnc servers. For each display, a different resolution and a different 
number of colors can be chosen. 

An Xvnc daemon can be used: 

- either to get a graphical login and to access a desktop (KDE, GNOME, etc.) 

- or to run automatically an X software (netscape, rdesktop, etc.) 

Select the method (<L>ogin or <A>ny software) : 
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3.2.1 - VNC Terminals with Login 

This method offers a standard Linux/Unix "login box" on the VNC terminal. This 
logon (username + password) allows the AX3000 user to be identified and given 
their respective desktop 

The procedure to set up a login session can vary on the display manager used. 
(See below). 

a) Display Manager KDE 2.2 

For KDE 2.2, VNC terminals can be declared either through /etc/inittab or the 
environment (x)inetd. 

There are two main differences: 

- inittab gives each terminal its own unique TCP port (5901, 5902, etc.). 

- (x)inetd requires only one TCP port for each type of terminal (example: 
5950 for all 800x600 and 256-colour terminals). 

Note: a more precise list of differences is given in Chapter 6.6. 

This chapter deals only with the (x)inetd method. For more information about the 
inittab method, consult the Section 'Other Display Managers'. 

After selecting the (x)inetd method, a similar screen is displayed: 


(x) inetd and /usr/share/conf ig/kdm/kdmrc will be modified. 

Please confirm: Y 

*** Checking INET environment (/etc/services and /etc/xinetd.d/vnc) 

800x600 - 8 bpp (port 5950) : OK 
800x600 - 16 bpp (port 5951) : OK 
1024x768 - 8 bpp (port 5952) : OK 
1024x768 - 16 bpp (port 5953) : OK 

*** Checking XDMCP ( /usr/share/conf ig/kdm/kdmrc) 
xdmcp has been already enabled ! 

The four 5950, 5951, 5952 and 5953 TCP ports have been set to handle VNC 
connections. 
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b) Other Display Managers 

The following screen allows the removal or addition of a VNC terminal with 
Login: 


MANAGING GRAPHICAL DISPLAY FILE 


Contents of /etc/inittab : 


1 

Xvnc 

800x600 - 

8 

bpp 

16 

free 

31 

free 

2 

Xvnc 

1024x768- 

8 

bpp 

17 

free 

32 

free 

3 

busy 




18 

free 

33 

free 

4 

free 




19 

free 

34 

free 

5 

free 




20 

free 

35 

free 

6 

free 




21 

free 

36 

free 

7 

free 




22 

free 

37 

free 

8 

free 




23 

free 

38 

free 

9 

free 




24 

free 

39 

free 

10 

free 




25 

free 

40 

free 

11 

free 




26 

free 

41 

free 

12 

free 




27 

free 

42 

free 

13 

free 




28 

free 

43 

free 

14 

free 




29 

free 

44 

free 

15 

free 




30 

free 

45 

free 


<A>dd a display / <D>elete a display / <M>odify a display settings / <Q>uit 
Enter your choice (A, D, M or Q) : 


A VNC terminal with Login is defined by: 

- its display number: this is the VNC session TCP port (1 =5901 , 2=5902...), 

- its resolution: 800x600 or 1024x768, 

- its number of supported colour bits: 8 bits/pixel. 

Notes: 

-Depending on the O.S., the Xvnc daemon will be launched either from 
Xservers or /etc/inittab. 

- If the entry of a display is described as 'busy' it means a VNC terminal 
WITHOUT login is assigned to that port. 

3.2.2 - VNC Terminal without Login 

Depending of the use of the terminal, a login and a desktop may not be needed. 
Running a dedicated application can be very useful. Examples: 

- "Intranet Terminal": running automatically Netscape, 

- "Windows Terminal": running automatically an RDP client. 

Note: refer to Chapter 6.5 for more information. 
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The following screen allows the addition or removal of a VNC terminal without 
Login (the application is automatically run): 


MANAGING GRAPHICAL DISPLAY FILE 

Contents of /etc/inittab: 



1 busy 

16 free 


2 busy 

17 free 


3 (800x600 - 8) /usr/local/bin/a . . . 

18 free 


4 free 

19 free 


5 free 

20 free 


6 free 

21 free 


7 free 

22 free 


8 free 

23 free 


9 free 

24 free 


10 free 

25 free 


11 free 

26 free 


12 free 

27 free 


13 free 

28 free 


14 free 

29 free 


15 free 

30 free 

<A>dd a display / <D>elete a display / <M>odify a display settings / <Q>uit 

Enter your choice (A, D, M or Q) : 



A VNC terminal without Login is defined by: 

- its display number: this is the VNC session TCP port (1=5901 , 2=5902...), 

- its resolution: 800x600 or 1024x768, 

- its number of supported colour bits: 8 bits/pixel, 

- the dedicated application (absolute pathname and parameters). 

Notes: 

-The Xvnc server and application are run by the RunScriptVNC script 
which is automatically created by axvnc. The RunScriptVNC scripts are 
launched through /etc/inittab. 

- If an entry in the display table is 'busy', it means the VNC terminal WITH 
login is assigned to this port. 
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3.3 - MANUALLY CONFIGURING THE UNIX/LINUX SERVER 

A new and separate VNC daemon (Xvnc) must be run for each Platine VNC 
session. Every Xvnc daemon controls a DISPLAY number (i.e. a VNC 
connection to 5901 , 5902, etc). 

There are different procedures for running the Xvnc daemon in the following 
environments: 

- Linux (Red Hat, Mandrake, SuSE, Caldera and Corel), 

- Unix SCO OpenServer, 

- UnixWare 7, 

- Open Unix 8, 

- AIX 4.x, 

- SunOS 5.6, 

- HP-UX 11. 

Note: the following examples describe how to set-up the Xvnc server for a 
800x600 resolution. To handle other resolutions refer to Chapter 6.4. 
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3.3.1 - LINUX 


Under Linux, X terminal devicess (including VNC terminals) are managed by a 
Display Manager. A Display Manager provides services similar to those provided 
by init, getty and login on character terminals: i.e. prompting for login name and 
password, authenticating the user and running a "session". 

The most common Display Managers (and their associated daemons) are: 

- KDE 2.2: kdm daemon, 

- KDE: kdm daemon, 

- GNOME: gdm daemon. 

To find out which Display Manager is being used by your system invoke the 
following command: 

# ps -ef | grep dm 


Note: if kdm is used, check if the Display Manager is KDE or KDE 2.2. 

If no gdm or kdm daemon is running: you MUST use a runlevel which 
handles graphical displays. This runlevel is operating system dependent. 
Generally this is runlevel 5. 

The following describes the VNC configuration with KDE 2.2, KDE and GNOME. 
a) KDE 2.2 (kdm) 

First, XDMCP must be enabled. This is done through the file kdmrc. The 
location of kdmrc depends on the operating system. Possible locations are 
/etc/kde/kdm, /usr/share/config/kdm or /opt/kde2/share/config/kdm. 

This file is divided into sections. In the xdmcp section, set the 'Enable' 
parameter to 'true': 

[xdmcp] 

Enable=true 


This modification will take effect after rebooting Linux, or invoking init twice to 
change the runlevel (invoke init 3 then init 5). 

Then the Xvnc daemon must be run through /etc/inittab. 
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Copy govnc.KDE22 from Axel supplied CD-ROM to /etc and rename to govnc. 
Set execute permission by invoking chmod +x /etc/govnc. 

For each VNC connection, add a line in /etc/in ittab as shown below (the govnc 
parameters are the DISPLAY number, the resolution and the number of 
bits/pixel): 

axvl : 5 : respawn : /etc/govnc 1 800x600 8 l>/tmp/axvnclogl 2>&1 
axv2 : 5 : respawn : /etc/govnc 2 800x600 8 l>/tmp/axvnclog2 2>&1 


These modifications will take effect after invoking: 

# init q 

The following shows the govnc script: 

DISPLAY=" : "$1 
PORT=' expr 5900 + $1' 

GEOMETRY=$2 

if [ "$3" = "8" ]; then 
BPP="-depth 8 -cc 3" 
else 

BPP=" -depth 16" 
fi 

/usr/local/bin/Xvnc $DISPLAY -ac -query localhost -once -geometry 
$GEOMETRY $BPP -rfbwait 120000 -rfbport $PORT 


These modifications will take effect after rebooting the Linux server. 

The Axel-VNCviewer should display an X login. If not, check the access 
restriction listed in Xaccess (generally any host is authorised). See Chapter 7.6. 

b) KDE (kdm) 

With KDE, X terminals are controlled through the Xservers file. The possible 
locations are operating system dependent: 

- /etc/xdm/X1 1 : Red Hat, SuSE and Mandrake 

- /etc/kdm/X1 1 : Open Linux Caldera 

- /usr/X1 1 R6/config/kdm: Corel Linux 
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For each VNC session, add the following lines (below two Platine VNC sessions 
are configured): 

:1 local /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 -rfbwait 
120000 -rfbport 5901 -fp unix/:-l -cc 3 -co /usr/lib/Xl 1/rgb 

:2 local /usr/local/bin/Xvnc :2 -ac -geometry 800x600 -depth 8 -rfbwait 
120000 -rfbport 5902 -fp unix/:-l -cc 3 -co /usr/lib/Xl 1/rgb 


Notes: 

- Each VNC line is different by the DISPLAY number (this number is given 
twice), and the -rfbport option which is the TCP port number entered 
through the AX3000 Set-Up (see Chapter 2). 

-The -fp unix/:-1 option requires a font server to be available. If the font 
server is not enabled, the Xvnc daemon will terminate. To check the X 
resources, invoke 'xset -q'. The font path section lists the font 
information. Use the same information for the Xvnc -fp option. For more 
information, refer to Chapter 7.2. 

- An example is given in the xservers. LINUX file. 

These modifications will take effect after resetting the Linux server. 

The Axel-VNCviewer should display an X login. If not, check the access 
restriction listed in Xaccess (generally any host is authorised). See Chapter 7.6. 

Going Further: 

In the same directory as Xservers, the Xsetup_0 file sets the DISPLAY 0 
behaviour (the main console). Copy this file to Xsetup_vnc. 


The DISPLAY profiles are run by the /etc/X11/xdm/xdm-config file. Add the 
lines relating to the VNC displays. For example: 


DisplayManager . 

_1 . setup : 

/etc/Xll/xdm/Xsetup_vnc 

DisplayManager . 

_2 . setup : 

/etc/Xll/xdm/Xsetup_vnc 


Note: if the keyboard management is not correct (i.e. unable enter the 
username through the X login box), the Xsetup_vnc file must be modified. 
Remove all lines related to the xmodmap command from this file. 
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c) GNOME (gdm) 


The gdm configuration file is /etc/X11/gdm/gdm.conf. This file is divided into 
sections. The XDMCP lists the following: 


[xdmcp] 

Enable=0 
Honor Indirect =0 


Set the 'Enable' parameter to 1 . 


[ xdmcp ] 

Enable=l 

HonorIndirect=0 


This modification will take effect after rebooting Linux, or invoking init twice to 
change the runlevel (example init 3 then init 5). 

Then the Xvnc daemon must be run through /etc/inittab. 

Copy govnc. LINUX from the Axel CD-ROM to /etc and rename it to govnc. Set 
execute permission by invoking chmod +x /etcx/govnc. 

For each VNC connection, add a line in /etc/inittab as shown below (the govnc 
parameters are the DISPLAY number, the resolution and the number of 
bits/pixel): 

axvl : 5 : respawn : /etc/govnc 1 800x600 8 l>/tmp/axvnclogl 2>&1 
axv2 : 5 : respawn : /etc/govnc 2 800x600 8 l>/tmp/axvnclog2 2>&1 


These modifications will take effect after invoking: 

# init q 


Installing and Using the Axel-VNCviewer 


17 













^XEL 


The following shows the govnc script: 

DISPLAY=" : "$1 
PORT=' expr 5900 + $1' 

GEOMETRY=$2 

if [ "$3" = "8" ]; then 
BPP="-depth 8 -cc 3" 
else 

BPP=" -depth 16" 
fi 

HOST=' hostname' 

/usr/local/bin/Xvnc $DISPLAY -ac -query $HOST -once -terminate -geometry 
800x600 -depth 8 -rfbwait 120000 -rfbport $PORT -fp unix/:-l -cc 3 -co 
/usr/lib/Xll/rgb 

IMPORTANT: The -fp unix/:-1 option requires a font server to be available. If 
the font server is not enabled, the Xvnc daemon will terminate. To check the X 
resources, invoke 'xset -q'. The font path section lists the font information. Use 
the same information for the Xvnc -fp option. For more information, refer to 
Chapter 7.2. 

Note for SuSE: if the keyboard management is not correct (i.e. unable enter the 
username through the X login box), the /etc/X11/xdm/Xsetup file must be 
modified. For the TCP/IP connections, remove all lines related to the xmodmap 
command from this file: 

if test -x $xmodmap ; then 

if test -z "$ (DISPLAY% : * } " ; then 

# local connection 

test -r $sysmodmap && $xmodmap $sysmodmap 

else 

# TCP/IP connection (remote or local) 

### NOT NEEDED FOR VNC 

### test -r $defmodmap && $xmodmap $defmodmap 

### test -r $hostmodmap && $xmodmap $hostmodmap 

fi 
fi 
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3.3.2 - SCO OPENSERVER 


a) SCO OpenServer 5.0.6 and 5.0.5 

Under SCO the scologin daemon provides services similar to those provided by 
init, getty and login on character terminals: i.e. prompting for login name and 
password, authenticating the user and running a "session". 

The /usr/lib/X11/scologin/Xservers file lists all managed X terminals. A VNC 
session is treated as a local connection by Linux (not as a 'foreign' connection). 

For each VNC session, add the following lines (below two Platine VNC sessions 
are configured): 

:1 local /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 
-fp /usr/lib/Xll/fonts/misc/, /usr/lib/Xll/fonts/Speedo/, /usr/lib/Xll/fo 
nts/Typel/, /usr/lib/Xll/fonts/75dpi/, /usr/lib/Xll/fonts/100dpi/ -cc 3 -co 
/usr/lib/Xll/rgb -rfbwait 120000 -rfbport 5901 

:2 local /usr/local/bin/Xvnc :2 -ac -geometry 800x600 -depth 8 
-fp /usr/lib/Xll/fonts/misc/, /usr/lib/Xll/fonts/Speedo/, /usr/lib/Xll/fo 
nts/Typel/, /usr/lib/Xll/fonts/75dpi/, /usr/lib/Xll/fonts/100dpi/ -cc 3 -co 
/usr/lib/Xll/rgb -rfbwait 120000 -rfbport 5902 


Important: each line is different from the other by: 

- the DISPLAY number (this number is given twice), 

-the -rfbport option. It is the TCP port number entered through the AX3000 
Set-Up (see Chapter 2). 

Note: an example is given in the xservers.SCO file. To add this line to the end 
of Xservers, invoke the following command (be careful to »): 

# cat /tmp/xservers . SCO >> /usr/lib/Xll/scologin/Xservers 


Reset the X server by invoking '"scologin stop", then "scologin start". The 
Axel-VNCviewer should display an X login (like the main console). 

Note: in event of keyboard difficulties, refer to Chapter 7.5. 
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b) Previous Versions of SCO OpenServer 

With previous versions of SCO scologin cannot be used. The Xvnc daemon 
must be run through /etc/inittab. 

Copy govnc.SCO to /etc and rename it to govnc. Set execute permission by 
invoking: 

# chmod +x /etc/govnc 

For each VNC connection, add a line in /etc/inittab as shown below (the govnc 
parameter is the DISPLAY number): 

axvl : 2345 : respawn : /etc/govnc 1 l>/tmp/axvnclogl 2>&1 
axv2 : 2345 : respawn : /etc/govnc 2 l>/tmp/axvnclog2 2>&1 

Note: to avoid these lines being removed after relinking the kernel, we advise 
you to create the file /etc/conf/init.d/vnc. This file must contain the lines related 
to govnc. 

The following shows the govnc script: 

DISPLAY=" : "$1 
PORT=' expr 5900 + $1' 

HOST=' hostname' 

/usr/local/bin/Xvnc $DISPLAY -query $HOST -once -terminate -auth 
.Xauthority -ac -geometry 800x600 -depth 8 -rfbwait 120000 -rfbport $PORT 
-fp 

/us r/lib/Xl 1/font s/mi sc/, /usr/lib/Xll/ fonts/Speedo/, /usr/lib/Xll/ fonts/Ty 
pel/, /usr/lib/Xll/fonts/75dpi/, /usr/lib/Xll/fonts/100dpi/ -cc 3 -co 
/usr/lib/Xll/rgb l>/tmp/axvnclog$l 2>&1 

These modifications will take effect after invoking: 

# init q 

The Axel-VNCviewer should display an X login (like the main console). 
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3.3.3 - UNIXWARE 7 


The following has been qualified for UnixWare 7.1.0 (after applying the ptf7408 
and ptf7446) and UnixWare 7.1.1. 

X terminals are handled by dtlogin under UnixWare. 

The parameter file of dtlogin is /usr/dt/config/Xservers. For each VNC session, 
add the following lines (below two Platine VNC sessions are configured): 

:1 local@none /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 -fp 
/usr/XHR6 . 1/lib/Xll/fonts /mi sc/, /usr/XHR6 . 1/lib/Xll/fonts/ Speedo/, /usr/ 
X11R6 . 1/lib/Xll/fonts/Typel/, /usr/XllR6 . 1/lib/Xl 1/fonts /75dpi/, /usr/XHR6 
. l/lib/Xll/fonts/100dpi/, /usr/dt/conf ig/xfonts/C -cc 3 -co 
/usr/lib/Xll/rgb -rfbwait 120000 -rfbport 5901 

:2 local@none /usr/local/bin/Xvnc :2 -ac -geometry 800x600 -depth 8 -fp 
/usr/XHR6 . 1/lib/Xll/fonts /mi sc/, /usr/XHR6 . 1/lib/Xll/fonts/ Speedo/, /usr/ 
X11R6. 1/lib /XI 1/ fonts/Typel/, /usr/XHR6 . 1/lib/Xll/fonts /75dpi/, /usr/XHR6 
. l/lib/Xll/fonts/100dpi/, /usr/dt/conf ig/xfonts/C -cc 3 -co 
/usr/lib/Xll/rgb -rfbwait 120000 -rfbport 5902 


Important: each line is different from the other by: 

- the DISPLAY number (this number is given twice), 

-the -rfbport option. It is the TCP port number entered through the AX3000 
Set-Up (see Chapter 2). 

Note: an example is given in the xservers.UW7 file. To add this line to the end 
of Xservers, invoke the following command (be careful to »): 

# cat /tmp/xservers . UW7 >> /usr/dt/config/Xservers 


Reset the X server by invoking "'scologin stop", then "scologin start". The 
Axel-VNCviewer should display an X login (like the main console). 
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3.3.4 -OPEN UNIX 8 

X terminals are handled by dtlogin under Open Unix 8 

The parameter file of dtlogin is /usr/dt/config/Xservers. For each VNC session, 
add the following lines (below two Platine VNC sessions are configured): 

:1 local@none /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 -cc 3 
-rfbwait 120000 -rfbport 5901 -fp /usr/XHR6 . 1/lib/Xll/fonts/misc/, /usr 
/X11R6 . 1/lib/Xll /fonts/Speedo/, /usr/XHR6 . 1/lib/Xll/fonts/Typel/, /usr/Xll 
R6 . 1/lib/Xll /fonts /75dpi/, /usr/XHR6 . 1/lib/Xll /fonts /100dpi/, /usr/dt/conf 
ig/xfonts/C -co /usr/lib/Xll/rgb 

:2 local@none /usr/local/bin/Xvnc :2 -ac -geometry 800x600 -depth 8 -cc 3 
-rfbwait 120000 -rfbport 5902 -fp /usr/XHR6 . 1/lib/Xll/fonts/misc/, /usr 
/X11R6 . 1/lib/Xll /fonts/Speedo/, /usr/XHR6 . 1/lib/Xll/fonts/Typel/, /usr/Xll 
R6 . 1/lib/Xll /fonts/75dpi/, /usr/XHR6 . 1/lib/Xll /fonts /100dpi/, /usr/dt/conf 
ig/xfonts/C -co /usr/lib/Xll/rgb 


Important: each line is different from the other by: 

- the DISPLAY number (this number is given twice), 

-the -rfbport option. It is the TCP port number entered through the AX3000 
Set-Up (see Chapter 2). 

Note: an example is given in the xservers.OU8 file. To add this line to the end 
of Xservers, invoke the following command (be careful to »): 

# cat /tmp/xservers . OU8 >> /usr/dt/config/Xservers 


Reset the X server. The Axel-VNCviewer should display an X login (like the 
main console). 
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3.3.5 - AIX 


Note: in this chapter we assume that the CDE windows manager is used by the 
AIX main console. If not, see the chapter about the installation under Linux with 
kdm. 

X terminals are handled by dtlogin under AIX. 

The parameter file of dtlogin is /usr/dt/config/Xservers. For each VNC session, 
add the following lines (below two Platine VNC sessions are configured): 

:1 local@none /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 -fp 
/usr/lib/Xll /fonts/, /usr/lib/Xll/ fonts/misc/, /usr/lib/Xll/ fonts/75dpi/, /u 
sr/lib/Xll/fonts /100dpi/, /usr/lib/Xll/fonts/ il8n/, /usr/lib/Xll/ fonts/ibm8 
50/, /usr/lib/Xll/fonts/TrueType/, /usr/lib/Xll/fonts/Typel/ -cc 3 -co 
/usr/lib/Xll/rgb -rfbwait 120000 -rfbport 5901 

:2 local@none /usr/local/bin/Xvnc :2 -ac -geometry 800x600 -depth 8 -fp 
/usr/lib/Xll/fonts/, /usr/lib/Xll/ fonts/misc/, /usr/lib/Xll/ fonts/75dpi/, /u 
sr/lib/Xll/fonts/ 100dpi/, /usr/lib/Xll/fonts/ il8n/, /usr/lib/Xll/ fonts/ibm8 
50/, /usr/lib/Xll/fonts/TrueType/, /usr/lib/Xll/fonts/Typel/ -cc 3 -co 
/usr/lib/Xll/rgb -rfbwait 120000 -rfbport 5902 


Important: each line is different from the other by: 

- the DISPLAY number (this number is given twice), 

-the -rfbport option. It is the TCP port number entered through the AX3000 
Set-Up (see Chapter 2). 

Note: an example is given in the xservers.AlX file. To add this line to the end of 
Xservers, invoke the following command (be careful to »): 

# cat /tmp/xservers . AIX >> /usr/dt/config/Xservers 


These modifications will take effect after resetting the X server. (Log out from 
the main console to reset the X server). 

The Axel-VNCviewer will display an X login (like the main console). 
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If the keyboard management is not correct (i.e. unable enter the username 
through the X login box), the /usr/dt/config/Xconfig file must be modified. This 
file describes X terminal settings. The following line could be in the file: 

Dtlogin*setup : Xsetup 


This line means the Xsetup file is used by ALL X terminals. To use a different 
file for each X terminal, replace this line by: 


Dtlogin*myhost_0*setup : 

Xsetup 

Dtlogin*myhost_l*setup : 

Xsetup_vnc 

Dtlogin*myhost_2*setup : 

Xsetup_vnc 


Note: in this example, myhost is the AIX hostname. 

The Xsetup_vnc file must be created in /usr/dt/config... This file is empty. 
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3.3.6 -SUN OS 5.6 


X terminals are handled by dtlogin under Sun OS. 

The parameter file of dtlogin is /usr/dt/config/Xservers. For each VNC session, 
add the following lines (below two Platine VNC sessions are configured): 

:1 local@none /usr/local/vnc/Xvnc :1 -ac -geometry 800x600 -depth 8 - 
rfbwait 120000 -rfbport 5901 -cc 3 -co /usr/openwin/lib/Xll/rgb -fp 
/ usr/openwin/lib/Xll/f onts /mi sc/, /usr/openwin/lib/Xll/f onts/75dpi/, 

/ usr/openwin/lib/Xll/f onts /100dpi 

:2 local@none /usr/local/vnc/Xvnc :2 -ac -geometry 800x600 -depth 8 - 
rfbwait 120000 -rfbport 5902 -cc 3 -co /usr/openwin/lib/Xll/rgb -fp 
/ usr/openwin/lib/Xll/f onts/misc/, /usr/openwin/lib/Xll/f onts/75dpi/, 

/ usr/openwin/lib/Xll/f onts /100dpi 


Important: each line is different from the other by: 

- the DISPLAY number (this number is given twice), 

-the -rfbport option. It is the TCP port number entered through the AX3000 
Set-Up (see Chapter 2). 

Note: an example is given in the xservers.SUN file. To add this line to the end 
of Xservers, invoke the following command (be careful to »): 

# cat /tmp/xservers . SUN >> /usr/dt/config/Xservers 


These modifications will take effect after resetting the X server. 

The Axel-VNCviewer will display an X login (like the main console). 
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3.3.8 -HP-UX 11 


X terminals are handled by dtlogin under HP-UX. 

The parameter file of dtlogin is /etc/dt/config/Xservers. For each VNC session, 
add the following lines (below two Platine VNC sessions are configured): 

:1 local@none /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 -cc 3 
-rfbwait 120000 -rfbport 5901 -co /usr/lib/Xll/rgb -fp /usr/lib/Xll/f onts 
/misc/, /usr/lib/Xll/fonts/hp_roman8/75dpi/, /usr/dt/conf ig/xf onts/C, /usr/1 
ib/Xll/fonts/iso_8859 . 15/7 5dpi 

:2 local@none /usr/local/bin/Xvnc :2 -ac -geometry 800x600 -depth 8 -cc 3 
-rfbwait 120000 -rfbport 5902 -co /usr/lib/Xll/rgb -fp /usr/lib/Xll/fonts 
/misc/, /usr/lib/Xll/fonts/hp_roman8/75dpi/, /usr/dt/conf ig/xf onts/C, /usr/1 
ib/Xll/fonts/iso_8859 . 15/7 5dpi 


Important: each line is different from the other by: 

- the DISPLAY number (this number is given twice), 

-the -rfbport option. It is the TCP port number entered through the AX3000 
Set-Up (see Chapter 2). 

Note: an example is given in the xservers.HPUX file. To add this line to the end 
of Xservers, invoke the following command (be careful to »): 

# cat /tmp/xservers . HPUX >> /etc/dt/config/Xservers 


These modifications will take effect after resetting the X server. 

The Axel-VNCviewer will display an X login (like the main console). 
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4.1 - OPENING A SESSION 

The default keystroke used to open a session is <Alt><Fx> (where <Fx> is a 
function key from <F1> to <F4>). 

When the VNC authentication is enabled (see Chapter 6.1) the VNC password 
must be entered. If the VNC authentication fails the VNC session is 
disconnected. 

On successful authentication, the Axel-VNCviewer displays a graphical login 
screen or a previously opened session depending which type of disconnection 
was previously performed 


4.2 - DISCONNECTING 

Three cases of disconnection can be distinguished: 

4.2.1 - Log out 

Note: only for SCO, UNIXWARE 7 and Linux with gdm. 

When the user selects ‘Exit session’ from the X desktop menu, the VNC 
connection is automatically closed. To get a new login screen, the user must 
open again a VNC connection (pressing <AltxFx>). 

©: if you need a new login screen to be displayed automatically, set 'auto 
reconnection' to 'yes' in the AX3000 Set-Up. 

4.2.2 - Voluntary Disconnection 

The user closes the VNC session at the AX3000 level by pressing 
<CtrlxAltxShiftxD>. At Unix level, the VNC session is not closed, the next 
time the Platine connects, the existing/current X screen will be displayed. 
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4.2.3 - Forced Disconnection 


Another VNC viewer has opened a VNC session with the same TCP port as the 
AX3000. In this case, the VNC server closes the AX3000 connection before 
accepting the second connection. 

Notes: 

-To prevent a VNC terminal being disconnected by a second VNC 
terminal, use the '-dontdisconnect' Xvnc option. Then second VNC 
terminal connection will be refused. 

- If a sharable VNC session is needed (i.e. several VNC viewers share the 
same graphical screen), refer to Chapter 6.2. 
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The AX3000 offers 4 independent and concurrent sessions. Each session can 
be used as: 

- a vnc session, 

- a text-based session (telnet or tty protocols). 


5.1 - VNC SESSION 

No specific setting is needed for a VNC session (no emulation or function key 
set up). 

Technical information: 

- resolutions: 800x600 and 1024x768 (according to the AX3000 hardware ; 
see Chapter 6.4), 

- colours: 256, 

- default VGA frequency: 72 Hertz, 

- mouse: a serial 2-button mouse. 

For best performance the X desktop should be set to: 

- background aspect: select a one-colour background (no colour-scale 
background or picture) 

- moving and resizing windows: set for these operations to be performed 
without displaying the window’s contents, (i.e. move the frame only) 


5.2 - TEXT-BASED SESSION 

There are two techniques used for text-based emulations: 

- Standard Text Mode - identical to the Ax3000 Models 55 and 55E 
-Alpha-GUI Mode (Revamping) which allows the display of GIF files and 
various shading and shadow effects for characters and semi-graphics 
characters 

Note: AX3000 are equipped with the real-text mode firmware. The alpha-GUI 
mode is an optional firmware. (This option is called AGA, AGV or AGW in the 
firmware revision) 
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The alpha-GUI mode has the following specifications: 

- only 80-column mode supported, 

- currently only supports ANSI, VT and WYSE emulations, 

- scrolling speed is lower, 

- blinking attribute not supported, 

- underline attribute supported in colour (which is not the case in real text 
mode). 

For more information about this mode, please refer to the Addendum - Alpha- 
GUI. 
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6.1 - VNC AUTHENTICATION 

The VNC protocol makes the AX3000 "stateless". If a user disconnects from a 
given server and subsequently reconnects to that same server, the state of the 
user interface is preserved. Furthermore, a different client (terminal) can be 
used to connect the same VNC server. 

This feature has many useful aspects, but also can have security implications. 
To provide security in this situation authentication can be enabled: ie a password 
is required when the VNC connection is opened. 

Note: this password is independent from the Unix log-on password 

To create (or modify) a VNC password invoke vncpasswd. (The only 
vncpasswd requirement is the /$HOME/.vnc directory exists), vncpasswd stores 
the password (and only one password) in the /$HOME/.vnc/passwd file. 

Before using vncpasswd, check the /$HOME/.vnc directory exists. If not, create 
one: 

# mkdir /$HOME/.vnc 


Creating one or more VNC passwords: 

Invoke vncpasswd. The password must be entered twice (6 characters at least). 
This password is stored in /.vnc/passwd. 

If several VNC passwords are needed, copy /.vnc/passwd to /.vnc/passwdl 
(/.vnc/passwd2, /.vnc/passwd3...). Then invoke again vncpasswd to enter 
another password. 

Modifying the Xvnc command line: 

To enable the VNC authentication, add the -rfbauth option in the Xvnc 
command line. This option must be followed by the password file. 
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Examples: 

Two VNC sessions with the same password: 


: 1 local 

/usr/local/bin/Xvnc :1 -ac 

-geometry 

800x600 -depth 

8 -fp 

unix/ : -1 

-cc 3 -co /usr/lib/Xll/rgb 

-rfbwait 

120000 -rfbport 

5901 - 

rfbauth / 

. vnc/passwd 




:2 local 

/usr/local/bin/Xvnc :2 -ac 

-geometry 

800x600 -depth 

8 -fp 

unix/ : -1 

-cc 3 -co /usr/lib/Xll/rgb 

-rfbwait 

120000 -rfbport 

5902 - 

rfbauth / 

. vnc/passwd 





Two VNC sessions with a different password: 


: 1 local 

/usr/local/bin/Xvnc :1 -ac 

-geometry 

800x600 -depth 

8 -fp 

unix/ : -1 

-cc 3 -co /usr/lib/Xll/rgb 

-rfbwait 

120000 -rfbport 

5901 - 

rfbauth / 

. vnc/passwdl 




:2 local 

/usr/local/bin/Xvnc :2 -ac 

-geometry 

800x600 -depth 

8 -fp 

unix/ : -1 

-cc 3 -co /usr/lib/Xll/rgb 

-rfbwait 

120000 -rfbport 

5902 - 

rfbauth / 

. vnc/passwd2 





Installing and Using the Axel-VNCviewer 


35 







^XEL 


6.2 - SHARABLE VNC SESSION 

By default, a VNC session is non-sharable. That means only one viewer can be 
connected to an Xvnc with a specific TCP port. If a second viewer tries to open 
the same VNC session as the first viewer, the first viewer is disconnected. (This 
behaviour can be changed by using the '-dontdisconnect' Xvnc option). 

It is however possible to share the same graphics session between several VNC 
viewers. 

Example: lessons or training. A teacher uses this Axel-VNCviewer and students 
follow these operations on their own Axel-VNCviewer. 

To set a VNC sharable session, enter the AX3000 Set-Up (<Ctrl><AltxEsc>), 
select [Configuration]-»[Terminal]->[Session X] (where X is the session 
number). Within this box select [General Parameters] and press <Space>. A 
dialog box is displayed. Within this box set the following parameters: 

- Shared Session: yes 

-Keyboard and Mouse Ignored: yes or no. In the 'teacher and students' 
example, select 'no' for the teacher's Platine and select 'yes' for the 
students' Platine. 

Note: to prevent a non-sharable VNC session disconnecting these sharable 
sessions, use the 'dontdisconnect' Xvnc option.. 
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6.3 - XVNC DAEMON 


The usage of Xvnc is: Xvnc :<display> [options] 


The main options are: 

:<display> 

-geometry <LxH> 
-depth D 
-cc <class> 

-co <file> 

-fp <file> 

-rfbport <port> 


-query <host> 


-ac 

-once & -terminate 
-dontdisconnect 


DISPLAY number handled by Xvnc (for example 
":1") 

screen size 

number of bits per pixel (8 bits = 256 colours) 
colour visual class (for more information, see next 
chapter) 

colour database file 

default font path(s). See Chapter 7.2. 

TCP port used for the connection. There is a 
connection between this value and the DISPLAY 
number (5901 is DISPLAY ":1", 5902 is ":2"....) 
using XDMCP request to get the "login screen". 
<host> is the name of the Unix box. Invoke 
hostname to know this name, 
disable access control restrictions 
the VNC connection is closed when the login session 
is closed 

don't disconnect existing clients when a new non- 
shared connection comes in (refuse new connection) 


For more information about other options, invoke: 

# Xvnc -h 2>&1 | more 
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6.4 - USING A DIFFERENT RESOLUTION 

6.4.1 - Checking Available Resolutions 

The minimum resolution supported by the AX3000 is 800x600. A higher 
resolution of 1024x768 is available for later models (1Mb memory models). 

To find out the memory size, press <CtrlxAltxEsc> and enter the AX3000 
Set-Up. Select the '?' on the far right and press <CR>. Check the VGA 
parameter value in the displayed dialog box. If this value is followed by (1Mb), 
1024x768 resolution is supported. If not only 800x600 is available. 

It is not possible to up-grade lower to higher resolution models. 

6.4.2 - Setting-Up the AX3000 

To set a VNC session in 1024x768, press <CtrlxAltxEsc> to enter the 
AX3000 Set-Up. Select [Configuration]-^[Terminal]->[Session X] (where X is 
the session number). A dialog box is displayed. Within this box select 'General 
Parameters'. In the displayed box, press <Space> to change resolution. 

6.4.3 - Setting-Up Xvnc 

A Xvnc server must handle the same resolution than the associated AX3000. 
Then, to handle a different resolution, the Xvnc command line must be modified. 
The command is generally run through the Xservers file (see Chapter 3). 

It's the geometry option which is involved. For example, this Xvnc command: 

:1 local /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 -rfbwait 
120000 -rfbport 5901 -fp unix/:-l -cc 3 -co /usr/lib/Xl 1/rgb 


must be replaced by: 

:1 local /usr/local/bin/Xvnc :1 -ac -geometry 1024x768 -depth 8 -rfbwait 
120000 -rfbport 5901 -fp unix/:-l -cc 3 -co /usr/lib/Xl 1/rgb 

This modification will take effect after resetting the X server or rebooting Unix. 
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6.5 - RUNNING SOFTWARE WITHOUT DISPLAY MANAGER 
OR DESKTOP 

The display manager and desktop processes allow a user to be authenticated 
(display manager) and run utilities or software through menus or icons 
(desktop). 

The process groups involved by these are mechanisms: 


▲ 

Software 


Desktop: KDE, GNOME, XFCE... 


Display manager: XDM, GDM, XDM... 


Xvnc 


This environment (login + desktop) is both safe and easy to use, but requires a 
large amount of memory. Below we discuss the option of running an application 
direct from Xvnc, without the Desktop or Display manager being loaded. This 
has two benefits, less memory is used, and often the user will not require a 
Linux/Unix desktop, preferring to launch direct into their application. 

-Example 1: only one application is run on the graphical terminal (for 
example Netscape). Once the terminal is powered-on, Nescape is 
automatically run. No Unix/Linux authentication is needed. Furthermore, 
the terminal will only run Netscape. 

- Example 2: the Unix/Linux box is used as a front-end to access a 
Windows box. Once the terminal is powered-on, an ICA client or a RDP 
client is automatically run. A Windows "login" screen is automatically 
displayed. The Unix/Linux box is invisible. 

For these configurations, the following architectures can be used: 


A 

Software 




Window manager: twm 

or 

Software 


Xvnc 


Xvnc 


Note: depending of the application, a window manager (twm) may be required. 
For example Netscape needs a window manager (several windows can be 
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created during the use of Netscape). Alternatively rdesktop software (RDP 
client) doesn't need a window manager. 

6.5.1 - The RunScriptVNC Script 

The RunScriptVNC script first runs the Xvnc daemon, then runs (in a loop) the 
dedicated application (binary or script). 

The axvnc utility (see Chapter 3.2) automatically creates RunScriptVNC in /etc. 
The following gives the content of this script: 

DISPLAY=" : "$1 
export DISPLAY 
PORT=' expr 5900 + $1' 

GEOMETRY=$2 

if [ "$3” = "8" ]; then 
BPP=" -depth 8 -cc 3" 
else 

BPP=" -depth 16" 
fi 

/usr/local/bin/Xvnc $DISPLAY -ac -geometry $GEOMETRY $BPP -rfbwait 120000 -rfbport 
$PORT -fp unix/:-l -co /usr/lib/Xl 1/rgb l>/tmp/axvnclog$l 2>&1 & 

sleep 1 

/usr/bin/Xll/xsetroot -solid grey 

shift 

shift 

shift 

CMD=$* 

TYPE=' /usr/bin/f ile $1' 

TEXT='echo $TYPE | grep "text"' 
if [ ! -z " $TEXT " ]; then 

CMD="/usr/bin/Xll/xterm -geometry 170x60-0+0 -e "$CMD 
fi 

while : 
do 

REP='ps -ef | grep "Xvnc $DISPLAY" | grep -v grep' 
if [ -z "$REP" ]; then 
exit 
fi 

$CMD 


RunScriptVNC is run by /etc/inittab. The /etc/inittab file is modified to launch a 
script for each VNC terminal. Example: 

axvl : 5 : respawn : /etc/RunScriptVNC 1 1024x768 8 /usr/local/bin/runRDP l>/tmp/axvnclogl 
2>&1 

axv2 : 5 : respawn : /etc/RunScriptVNC 2 800x600 8 /usr/local/bin/runNS 2 800x600 
l>/tmp/axvnclog2 2>&1 
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Note: the RunScriptVNC parameters are the screen number, the resolution, the 
number of colours (bits/pixel) and the dedicated application (absolute pathname 
and parameters). 

6.5.2 - Internet Terminal: Automatically Running Netscape 

Instead of running the Netscape binary, it's better to run a script which performs 
the following operations: 

- running a window manager (twm). As Netscape generally creates 
windows whilst browsing a windows manager is required. 

- setting environment variables to allow Netscape to use different locations 
for its resources (cache, historic files, etc.) according the display number. 
In this case the following users are created: axell , axel2, axel3, etc. 

This is the runNS script (two parameters are needed, the screen number and 
the resolution): 


# ! /bin/sh 
MYUSER= " axe 1 " $ 1 
HOME=/home/$MYUSER 
LOGNAME=$MYUSER 
USER=$MYUSER 
USERNAME=$MYUSER 
DISPLAY=" : "$1 
export DISPLAY 

### IMPORTANT: add these 2 parameters in /usr /lib/Xll/twm/system . twmrc 
### RandomPlacement 

### UsePPosition "on" 

/usr/bin/Xl 1 /twm -display $DISPLAY & 

/usr/bin/netscape -display $DISPLAY -geometry $2+0+0 http://www.axel.com 


This script is run through /etc/inittab. Example: 

axvl : 5 : respawn : /etc/RunScriptVNC 1 800x600 8 /usr/local/bin/runNS 1 
800x600 l>/tmp/axvnclogl 2>&1 


6.5.3 - Windows Terminal: Automatically Running Rdesktop 

Note: rdesktop is a Unix/Linux "RDP 4" client. The rdesktop source code is 
available at http://www.rdesktop.org. This software allows a Unix/Linux client 
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to attach to a Windows server (TSE or 2000 Advanced Server) using the "RDP 
4" protocol. 

Rather than running the rdesktop binary, there are benefits in running a script 
which asks the user to press a key before running rdesktop (i.e. opening an 
RDP connection). This avoids the continual respawning of RDP connections, 
which are automatically killed by Windows if nobody logs in. 

This is the runRDP script which runs rdesktop: 

# ! /bin/sh 
clear 

echo " RDP CONNECTION" 

echo " " 

echo "" 
echo "" 
echo "" 
echo "" 
echo "" 
echo "" 

echo "PRESS <CR> TO BEGIN” 
read key 

/usr/bin/Xl 1 /xmodmap -e "keycode any = EuroSign" 

/usr/bin/Xl 1 /xmodmap -e "keycode any = Caps Lock" 

/usr/local/bin/rdesktop -v -V -k fr -F 192.168.1.160 

This script is run through /etc/inittab. Example: 

axvl : 5 : respawn : /etc/RunScriptVNC 1 1024x768 8 /usr/local/bin/runRDP 
l>/tmp/axvnclogl 2>&1 
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6.6 - USING (X)INETD WITH KDE 2.2 

Under a Linux KDE 2.2 environment, the installation method described in 
Chapter 3.3.1 is based on /etc/inittab. But Xvnc daemons can also be run 
through inetd (or xinetd). 

The configuration shown below enables 2 VNC connection ports: 

- 5950 for 800x600 and 256-colour terminals, 

- 5952 for 1024x768 and 256-colour terminals. 

This allows all the 800x600/256-colour terminals to open a VNC connection on 
the same TCP port (5950). Similarly 1024x768/256-colour terminals can be 
configured to use port 5952). 

The main differences between the 'inittab' method and the '(x)inetd’ method are: 



/etc/inittab 

(x)inetd 

Number of Xvnc daemon 
run at the Linux boot-up 

one per terminal 

none 

TCP Ports 

one per terminal 

the same of all 

Display Numbers 

fixed 

dynamic 

In event of incident 
(Terminal power loss) 

graphical context can 
be retrieved 

graphical context is lost 
(come back to login) 

Sharable session 

yes 

no 


Note: installing Xvnc through inetd can be compared with the server telnet 
daemon: a telnet daemon is only run when a telnet connection is established, tty 
are dynamically allocated and the context (screen) is lost in event of incident. 

The inetd method is a three-step installation: 

- updating the inetd or xinetd environment, 

- checking access rights, 

- enabling XDMCP. 

6.6.1 - Updating the inetd or xinetd Environment 

The first operation is modifying the file /etc/services. Add the following lines at 
the end of the file: 
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vnc-800x600-8 

5 950 /tcp 

vnc-1024x768-8 

5 952 /tcp 


Then, check if inetd or xinetd is running. The next operation depends on the 
daemon. 

a) xinetd Daemon 

If the directory /etc/xinetd.d exists, create the file /etc/xinetd.d/vnc and add the 
following lines. If /etc/xinetd.d does not exist add these lines at the end of 

/etc/xinetd.conf: 


service vnc-800x600-8 

{ 

disable = no 
protocol = tcp 
socket_type = stream 
wait = no 
user = nobody 

server = /usr/local/bin/Xvnc 

server_args = -inetd -query localhost -once -geometry 800x600 -depth 8 -cc 3 

} 

service vnc-1024x768-8 

{ 

disable = no 
protocol = tcp 
socket_type = stream 
wait = no 
user = nobody 

server = /usr/local/bin/Xvnc 

server_args = -inetd -query localhost -once -geometry 1024x768 -depth 8 -cc 3 

} 


These modifications will take effect after sending the signal USR2 to xinetd (kill 
-USR2 ...). 
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b) inetd Daemon 

If the directory /etc/inet.d exists, create the file /etc/inet.d/vnc and add the 
following lines. If /etc/inet.d does not exist add these lines at the end of 

/etc/inetd.conf: 


vnc-800x600-8 stream tcp nowait nobody /usr/local/bin/Xvnc Xvnc -inetd -query 
localhost -once -geometry 800x600 -depth 8 -cc 3 

vnc-1024x768-8 stream tcp nowait nobody /usr/local/bin/Xvnc Xvnc -inetd -query 
localhost -once -geometry 1024x768 -depth 8 -cc 3 

These modifications will take effect after sending the signal HUP to inetd (kill 
-HUP ...). 

6.6.2 - Checking Access Rights 

The access rights are listed in the file Xaccess. 

Check if VNC terminals are allowed to be connected. For example, comment 
out this line: 

* #any host can get a login window 


If this file is modified, reboot Linux. 

6.6.3 - Enabling XDMCP 

First, XDMCP must be enabled. This is done through the file kdmrc. The 
location of kdmrc depends on the operating system. Possible locations are 
/etc/kde/kdm, /usr/share/config/kdm or /opt/kde2/share/config/kdm. 

This file is divided into sections. In the xdmcp section, set the 'Enable' 
parameter to 'true': 

[xdmcp] 

Enable=true 


This modification will take effect after rebooting Linux. 
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6.7 - COLOUR CLASS 

The Axel-VNCviewer supports 256 colours, but some software may display 
pictures with more than 256 colours, i.e. a website with 1 6-bit per pixel pictures. 

To handle this many colours the Xvnc daemon must modify the 'colour class’ 
and this may change the appearance of the picture. 

This colour modification strategy is controlled by the Xvnc option '-cc' (colour 
class). Two values for this option can be used depending on the use of the 
Platine: 

-cc 2 (default) 

-cc 3 

If the colour management is not satisfactory, test these two values by modifying 
the Xvnc command. 
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7.1 - THE AX3000 DISPLAY IS BLACK OR DISTORTED 

The default VGA frequency used by the AX3000 is 70 Hertz. If the VGA monitor 
does not support this frequency the display will be black or distorted (vertical 
sync is lost). 

To fix this problem either use a more modern monitor (SVGA) or perform one of 
the following operations depending on the AX3000 mode (see Chapter 5.3): 

a) Real Text Mode 

Enter the AX3000 Set up (<CtrlxAltxEsc>) and select the [Configuration]-* 
[Advanced]-*[Tunings] menu. Within the dialog box select the 'Scan 
frequency (VNC)' parameter and press <spacebar> to select the minimum 
frequency (60 Hertz). 

b) Alpha-GUI Mode 

Enter the AX3000 Set up (<CtrlxAltxEsc>) and press <F12>. The VGA 
frequency is set to 60 Hertz and the display becomes visible (this emergency 
procedure modifies the VGA frequency only during the set up stage). Then 
select the [Configuration]-*[Advanced]-»[Tunings] menu. Within the dialog 
box select the 'Scan frequency' parameter and press <spacebar> to enter the 
associated dialog box. The minimum frequency value can be selected (60 
Hertz). 
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7.2 - AX3000 FONTS ARE NOT AS EXCEPTED 

The X server (either the main console or the Xvnc daemon) locates the available 
fonts through the '-fp' option (see Chapter 6.3). 

The '-fp' option lists 

- the font path names (ex.: /usr/lib/X1 1/font/misc) 

- the available font servers. A font server can be located anywhere on the 
network (ex.: tcp/mysf:5701) or local (ex.: unix/:-1). 

Example: 

-fp unix/ : -1, /usr/lib/Xll/font/misc/, /usr/lib/Xl 1/font /Typel/ 


Caution: Be careful of the argument’s order . 

If the AX3000 fonts are not the same as those of the main console or if the Xvnc 
fails, perform the following: 

- Log on the main console 

- Invoke 'xset -q'. This command lists the X resources. The font path 
section lists the available fonts. Use the same information for the Xvnc -fp 

option. Example for SuSE 7.0: 

:1 local /usr/local/bin/Xvnc :1 -ac -geometry 800x600 -depth 8 -rfbwait 
120000 -rfbport 5901 -fp usr/XHR6/lib/Xll/fonts/75dpi : unsealed, 
/usr/XHR6/lib/Xll/ fonts /local, /usr/XHR6/lib/Xll/ fonts /mi sc : unsealed, /us 
r/XHR6/lib/Xll/ fonts/ 100dpi : unsealed, /usr/XHR6/lib/Xll/ fonts /Typel, /usr 
/XllR6/lib/Xll/ fonts/URW, /usr/XllR6/lib/Xll/ fonts/ Speedo, /usr/XHR6/lib/X 
11/ fonts /mi sc, /usr/XHR6/lib/Xll/ fonts/75dpi, /usr/XHR6/lib/Xll/ fonts/ 100 
dpi, /usr/XHR6/lib/Xll/ fonts/latin2/75dpi, /usr/XHR6/lib/Xll/ fonts/latin2 
/100dpi, /usr/XHR6/lib/Xll/fonts/uni -cc 3 -co /usr/lib/Xll/rgb 

- Reset the Xvnc daemon for this modification to take effect. 

Note about the font servers: if a font server is used, check the number of 
clients supported by this server (this is the 'client-limit' capability in 
/etc/X11/fs/config). For 4 Axel-VNCviewers, 'client-limit' must be set to 5 (4 
Platine + the main console). 
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7.3 - LINUX: 'WHO' COMMAND DOESN'T LIST VNC USERS 

The 'who' command (used to list connected users) does not show users 
connected via a VNC session. 

This problem is common to all X terminals using xdm, as xdm does not update 
utmp/wtmp entries. 

To fix this problem two scripts must be created. One to add a utmp/wtmp entry 
and the other to remove the entry. These utmp/wtmp modifications are 
performed by the system command sessreg. See examples below of these two 
scripts (they are available on the CD-Rom): 

addvncsess 

/usr/XHR6/bin/sessreg -a -1 $DISPLAY -x /usr/lib/Xll/xdm/Xservers $USER 


delvncsess 

/usr/XHR6/bin/sessreg -d -1 $DISPLAY -x /usr/lib/Xll/xdm/Xservers $USER 

Copy these scripts in /usr/lib/X1 1/xdm. 

The addvncsess script must be run at the X session start-up and the delvncsess 
script must be run at the X session reset (close). This is done by the 

/usr/lib/X1 1/xdm/xdm-config file. 

In this file, for each VNC session, add the following lines (below two Platine VNC 
sessions are configured): 

DisplayManager ._1 . xs tart up : / usr/lib/Xl 1/xdm/ addvncsess 

DisplayManager ._1 . reset : /usr/lib/Xll/xdm/delvncsess 

DisplayManager . _2 . xs tart up : / usr/lib/Xl 1/xdm/ addvncsess 

DisplayManager ._2 . reset : /usr/lib/Xll/xdm/delvncsess 


The 'who' command will show all subsequent user connections. 
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7.4 - RED HAT: DPMS ERROR MESSAGE 

After entering your username and password, the message "XII server lacks 
DPMS support" may be displayed. To prevent this invoke the following 
command: 

# rm -f /usr/share/applnk/Settings/Desktop/kcmdpms . kdelnk 


7.5 - SCO: KEYBOARD DIFFICULTIES WITH SCOTERM 

The ScoTerm application is the default 'graphical' shell offered by SCO. Within 
the ScoTerm box sometimes the keyboard management is not correct. (There is 
no problem with other shell boxes, for example XTerm). 

To fix this, edit the /usr/lib/X1 1/app-defaults/ScoTerm file. In this file, comment 
out the keyboard capabilities in the 'Keyboard resources' section. 

If needed, a mapchan file can be specified: 

*mapchan : /usr /lib/mapchan/ cons . ibm 


7.6 - XVNC: ERROR MESSAGE "HOST UNWILLING" 

When the VNC server displays this type of message: 

XDMCP fatal error: Manager unwilling Host unwilling 


That means the XDMCP process is not authorised to run a login onto this VNC 
server. 

The access restrictions are listed in the file Xaccess. Modify this file to authorise 
Xvnc terminals access and reboot the Linux system. 
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7.7 - XVNC: ERROR MESSAGE "FONT FIXED" 

When the VNC server displays this type of message: 

Could not open default font 'fixed'. 


That means no fixed font is available. 

Note: the font paths handled by Xvnc are given by the '-fp' option. 

Three methods are available to fix this problem: 

1 -Check if your Linux is consistent (for instance, are there directories on 

the Xvnc font path which don't actually exist on your system). To fix that 
use the ’mkfontdir' command or update Linux by installing packages. 

2 - Modify the '-fp' option value. Add or remove font paths. 

3 - Remove the ’-fp' option from the Xvnc command. Then, Xvnc will use 

default font path. 

Note: if the Axel VNC utility (axvnc) is used, run 'axvnc -nofp’. This will 
prevent Xvnc to use customised font paths. 
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